home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / backup / kbackup-.000 / KBackup-1.2.7.tar / KBackup / docs / manual.asc < prev    next >
Text File  |  1996-03-27  |  69KB  |  2,188 lines
  1. The KBackup User Manual        
  2. Version 1.2.7
  3.  
  4. (C) Copyright 1995, 1996 by Karsten Ballⁿder
  5. All Rights reserved.
  6.  
  7. e-mail: karsten@piobelix.physik.uni-karlsruhe.de
  8.  
  9.  
  10. This ASCII version of the manual has been created automatically using
  11. some rather crude tools. If you can, access the HTML version or print
  12. the formatted manual.
  13.  
  14. To find a certain passage, use the "/" key.
  15.  
  16.  
  17.  
  18.  
  19.     Structure of this manual:
  20.  
  21.         Introduction
  22.         Copyright Notice
  23.         Changes against prior versions
  24.         Making Backups
  25.         Restoring Backups
  26.         Other Actions
  27.         Scheduled Operations
  28.         Configurations
  29.         Options Overview
  30.         The MultiBuf  Program
  31.         Frequently Asked Questions
  32.         Copyright and Conditions of Use - the GPL
  33.  
  34. Chapter:            Introduction
  35. =========================================================================
  36.  
  37.  
  38. Purpose of KBackup
  39. =================================
  40.  
  41. KBackup is intended for handling of backups no matter whether they 
  42. reside on disk or tape or even in files. As most other backup programs 
  43. available today are either confusing the user with lots of long command
  44. line options or user friendly but not powerful at all, the aim behind
  45. writing KBackup was to provide a user friendly yet powerful backup
  46. program. Further on I wanted to keep it compatible to existing and well
  47. proven archive formats so you can restore your archives even if you should
  48. not have KBackup around anymore. 
  49.  
  50. To achieve this goal, KBackup uses established and well proven archive
  51. tools like tar(1) or afio(1) to do the archive handling and
  52. improves their functionality by adding quite a lot of additional
  53. features. By using the dialog(1) program I could
  54. make archive handling as easy and user friendly as possible.
  55. This means that you will get the power and reliability of the best archive
  56. handlers combined with a customisable and easy to use interface.
  57.  
  58.  
  59. Features
  60. =================================
  61.  
  62. Although KBackup uses other common tools to handle its archives, it
  63. provides additional features to make your life easier. These include
  64.  
  65.  
  66.  * 
  67. Each archive on a tape is preceded by a header containing option
  68. settings, parameters, compression format, date, backup type,
  69. etc.
  70. This maintains compatibility across different versions of this
  71. software and, as it is stored in readable format, helps you restore
  72. the data manually if you cannot use KBackup for what reason ever
  73. For restoring KBackup version 1.0 or 1.1 archives, please
  74. refer to the section txt_seqinfo or the FAQ.
  75. .
  76.  * 
  77. When using tapes or mountable block devices (see section txt_mountable_blkdev), a complete directory of all files in the archive gets
  78. stored at the beginning of the archive. You no longer need to read all
  79. the long archive to find out what files it contains.
  80.  * 
  81. Archive format and compression method as well as other parameters get
  82. detected automatically during restore or verify operation. You do not 
  83. need to know how you created the archive, KBackup will find it out for you.
  84.  *  
  85. You can use gzip(1) or compress(1) to compress your
  86. archives.
  87.  * 
  88. If you have some sensitive data, you can use pgp(1) (Pretty Good
  89. Privacy) to compress
  90. and encrypt your archives using public key encryption. (Ever wanted to
  91. send a tape or disk of sensitive data to someone else? Now you can!)
  92. For legal reasons, pgp(1) is not included in this
  93. package. You can obtain different version from file servers all over
  94. the world. I have been using KBackup with pgp version
  95. 2.6.2i. Pgp is written and copyright by Philip Zimmermann.
  96.  * 
  97. You can schedule backup or restore operations to be executed at a later
  98. time or even regularly. KBackup supports full at(1)
  99. functionality.
  100.  * 
  101. KBackup can use double buffering to keep your tape drive streaming
  102. continuously even on slow or heavily loaded machines. No longer corrupt
  103. your tapes by starting and stopping the drive every few seconds.
  104.  * 
  105. You can keep lists of files and directories that you want to exclude 
  106. from backups. You can also include and/or exclude files by using
  107. standard shell patterns.
  108.  * 
  109. You have the choice between full or incremental backups.
  110.  * 
  111. KBackup supports tapes, floppy--drives and removable media like
  112. removable hard--drives, magneto-optical drives or others.
  113.  *     
  114. You can keep different configuration files for your backup
  115. tasks.
  116. Sample configurations files for backups to tape or floppy disk
  117. are included. No manual configuration file editing, just go through the
  118. menus and change whatever you like.
  119.  * 
  120. Reliably handle multi--volume archives. There is no limit for your
  121. archives' sizes. By using the MultiBuf program,
  122. KBackup automatically detects the length of your tapes. 
  123.  * 
  124. The same MultiBuf program is capable of performing any operation on
  125. the end of a tape, like e.g. telling an automatic loading mechanism to
  126. change tapes.
  127.  * 
  128. New: support for accessing remote devices for easy support of LAN backups.
  129.  
  130.  
  131.  
  132.  
  133. Compatibility
  134. =================================
  135.  
  136. Although KBackup adds lots of functionality, its archives are still
  137. readable by afio(1) or tar(1), depending on which one was used
  138. to create it. To do so, on tapes, KBackup writes several files per
  139. archive: an archive header containing information about the archive
  140. type, compression method, date, , the table of contents
  141. (gzip(1)--compressed) and the actual archive file itself (If
  142. using sequence information for the MultiBuf program, it creates
  143. another two (short one--block) files.). To restore multivolume
  144. archives, all you need is the archive handler (afio(1) or
  145. tar(1)) and MultiBuf, which is included in ANSI--C
  146. source code an should easily be compiled on  any system.
  147.  
  148. If you do not want to use MultiBuf, you can switch it off and write plain
  149. tar(1) or afio(1) archives.
  150.  
  151. Unfortunately, the many new features, especially the secure
  152. multivolume support, required some changes to the way archives get
  153. written to the tape. However, KBackup is able to autodetect whether
  154. MultiBuf has been used in archive creation and therefore is still capable
  155. or reading archives that have been created by earlier versions of KBackup.
  156. It is currently not possible to restore multivolume archives that
  157. have been created with older versions of KBackup. As they were somehow
  158. unreliable anyway, better use a version newer than 1.2 to make new backups.
  159.  
  160. To restore old multivolume archives, created with version 1.0
  161. or 1.1, you have to use tar(1) or afio(1) manually.
  162.  
  163.  
  164. Restoring any archive manually (optionally using
  165. MultiBuf) is always possible, anyway.
  166.  
  167.  
  168.  
  169. supported devices
  170. =================
  171.  
  172.  
  173. Tape drives
  174.  
  175. KBackup should works with all tape drives supported by Linux.
  176. You need to have a properly configured tape driver in your kernel. If
  177. other programs work with your tape drive, KBackup will as well.
  178. KBackup is able to autodetect your tape device and test it for
  179. compatibility. 
  180.  
  181. KBackup has been reported to work with tape drives on a QIC-02
  182. controller, many different SCSI streamers and DAT drives
  183. as well as with the ftape driver version 2.03 (drives controlled
  184. by the floppy controller). It has reported not to work with
  185. zftape yet. It has also been reported to work with the IOmega
  186. ZIPdrive(TM)$, both the SCSI version as well as the
  187. alpha driver for the parallel-port version.
  188.  
  189. I am using and testing KBackup with a (rather old) Tandberg drive  
  190. on a no-name QIC-02 controller.Tandberg
  191. The QIC-02  driver implements the ``/dev/tape-reset''
  192. device, so KBackup can use it to reset the driver at your request. 
  193. I have not heard of any other driver supplying this pseudo--device.
  194.  
  195.  
  196. For more details on using floppy streamers (the ftape and
  197. zftape drivers), see the
  198. Ftape-HOWTOftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/Ftape-HOWTO.
  199.  
  200.  
  201. Floppy disks
  202.  
  203.  
  204. KBackup can support floppy disks in either of two ways:
  205.  
  206.  
  207.  * 
  208.     By writing straight to the disk using afio(1) or
  209.     tar(1) to write directly to the block device. This is
  210.     not recommend, because error detection is not too
  211.     good. However, this gives the highest capacity per disk.
  212.  * 
  213.     By treating floppy disks as ``general block devices''
  214.     . This is highly recommended, see next section
  215.     for details.
  216.  
  217.  
  218. If you want to use higher than normal capacity floppy formats with
  219. KBackup, this is no problem. Just tell it about it in the options menu.
  220.  
  221.  
  222. Block devices, ZIP drive
  223.  
  224. KBackup can use any block device which can be formatted and
  225. mounted, using the BLOCKDEV archive type.
  226.  
  227. In this case, it will (optionally) format and mount the device and
  228. write to it. This is the best way to use floppy disks floppy
  229. disks and the only way to use removable hard disks, like the IOmega
  230. ZIPdrive. 
  231.  
  232.  
  233.  
  234. MultiBuf and Compatibility
  235. =================
  236.  
  237. All that MultiBuf does, is to split the archive in multiple parts at
  238. well defined block sizes. If a block does not fit onto the tape, it
  239. prompts you for the next tape and starts it with this block again.
  240. Without MultiBuf, restoring these archives might be tricky,
  241. especially if you are using the sequence information option.
  242. However, as MultiBuf is written in plain ANSI--C it should
  243. compile cleanly on any system. The source of it is included
  244. with KBackup, so is a Makefile for compilation.
  245.  
  246.  
  247. Limitations, Bugs
  248. =================================
  249.  
  250.  
  251. Well, all limitations of the archive tools used by KBackup 
  252. still apply. If e.g. afio(1) has a bug, KBackup will have it, too.
  253.  
  254. Another serious limitation occurs when using pgp(1) for encrypting 
  255. archives. Pgp(1) creates temporary files during
  256. operation, so that, when using tar(1) the maximum size 
  257. of the archive is somehow limited by your free disk space in the
  258. directory for storing temporary files. Better use afio(1)
  259. for writing encrypted archives, not tar(1).
  260.  
  261. This problem has led to some patches for afio(1) and I hope they will
  262. make it into the official release soon, so that KBackup will be able to
  263. provide secure encryption.
  264.  
  265.  
  266. A problem with tar(1)
  267. =================
  268.  
  269. I have experienced a rather strange behaviour when using tar(1): it did
  270. not backup files with a length of zero. While in this case no data gets lost,
  271. this might still cause inconsistencies for applications. These files might be
  272. lock files or whatsoever and if they do not get backed up, who knows what
  273. happens. This error does not occur with afio(1).
  274.  
  275.  
  276.  
  277. Requirements
  278. =================================
  279.  
  280. KBackup requires some other software to be installed on your
  281. system. However, most of them should be available on any properly
  282. installed  system. If you are using a Slackware--based ,
  283. all you need is to install afio(1) on your machine.
  284.  
  285. The programs required by KBackup are:
  286.  
  287.  
  288.  * 
  289. dialog: the dialog program is being used for doing all the user
  290. interaction. 
  291. If dialog(1) is not available, KBackup will fall back to
  292. . Without dialog(1), it is still fully
  293. functional (just a bit ugly)!
  294.  * 
  295. gtar: the GNU tape archiver. A normal tar(1) will not
  296. do! Under , tar(1) is GNU's tar, so do not
  297. worry.
  298.  * 
  299. afio: the archive program. It is KBackup 's preferred archive
  300. handler, somehow more powerful than tar, but less well
  301. tested.
  302.  * 
  303. grep, fgrep, sed:
  304. some text processing programs that should be installed on every proper
  305.  system.
  306.  
  307.  
  308.  
  309. In fact, you do not need both, tar(1) and afio(1). KBackup can
  310. use either of them to handle its archives. Afio is strongly
  311. recommended. For handling encrypted archives , you
  312. should get afio(1) version 2.4.2 or newer.
  313.  
  314. In the file paths, you can set environment variables pointing
  315. to the various programs. Just in case the standard settings should not
  316. work for you.
  317.  
  318. KBackup should run with any Bourne Shell (sh(1)) compatible shell.
  319. However, I have mainly tested it using the Bourne-Again Shell
  320. (bash(1)), therefore I cannot guarantee that it will work with
  321. others, but I do not see any problems. Especially, it appears to be
  322. working well with the rather small ash(1) shell, which is of
  323. interest for putting it onto boot disks.
  324.  
  325.  
  326. Operating Systems supported
  327. =================================
  328.  
  329. KBackup is being developed and maintained on a standard  system. 
  330.  
  331. As it is a shell script, it is highly portable and should run on any UNIX
  332. system around. However, there might still be some work required to get it
  333. to run on other systems but . You no longer need the dialog(1)
  334. program as KBackup can now run without it.
  335.  
  336. There is currently work going on in making KBackup run under ULTRIX.
  337.  
  338.  
  339. Reliability a warning
  340. =================================
  341.  
  342. Well, I believe KBackup is  well tested by now. 
  343.  
  344. Of course, I have tried to test it as much as I could before
  345. releasing it. But, I can only test KBackup in my working
  346. environment with my hardware and my software setup. Although I have
  347. fixed all reported problems from previous versions, there might still
  348. be  one with your setup. So, before relying on KBackup, test
  349. it for yourself! Make a small backup and check whether you can
  350. successfully restore it (I recommend you using the ``/tmp''
  351. partition, not your real data directories.). 
  352.  
  353. These comments apply to backup software in general, not only to
  354. KBackup. So don't be frightened, I believe it is safe to use and
  355. trust it for my own backup needs.
  356.  
  357. So far I have received some hundred mails concerning KBackup,
  358. therefore most bugs should be fixed.
  359.  
  360.  
  361. Further Information
  362. =================================
  363.  
  364. Further information on KBackup and related topics can be found at:
  365. my
  366. homepagehttp://www.uni-karlsruhe.de/~ Karsten.Ballueder.
  367.  
  368. In that place you will always find the latest up-to-date information,
  369. bug--fix release and an online version of the complete KBackup and
  370. MultiBuf documentation (this manual). 
  371.  
  372.  
  373. Where to get those programs?
  374. =================
  375.  
  376. In the online version of the manual, you will find hyperlinks to the
  377. programs mentioned throughout this manual.
  378.  
  379. These are:
  380.  
  381.  
  382.  * 
  383. The
  384. pgp(1)
  385.         ftp://ftp.th-darmstadt.de/pub/security/pgp
  386. public key encryption program.
  387.  * 
  388. The
  389. afio(1)
  390.         ftp://sunsite.unc.edu/pub/Linux/system/Backup
  391. archive handler.
  392.  * 
  393. The dialog(1) program in its
  394. official release
  395.             ftp://sunsite.unc.edu/pub/Linux/utils/shell
  396. and in the latest
  397. beta/developement release
  398.             ftp://foggy.systemy.it/pub/dialog
  399. .
  400.  
  401. There are also other (non official) variants that might work for
  402. you. However, KBackup does no longer require dialog(1) for its operation.
  403.  
  404.  
  405.  
  406. Chapter:            Copyright
  407. =========================================================================
  408.  
  409.  
  410.  
  411.  Copyright (C) 1995, 1996 Karsten Ballⁿder
  412. Karsten.Ballueder@stud.uni-karlsruhe.de
  413. http://www.uni-karlsruhe.de/~ Karsten.Ballueder/
  414. Karsten Ballⁿder, Lessingstrasse 2, 32756 Detmold, Germany
  415.  
  416.  
  417. 2
  418.  
  419. KBackup is distributed with no warranty whatever.  The author
  420. and any other contributors take no responsibility for the consequences of
  421. its use.
  422.  
  423.  
  424. This is SHAREWARE:
  425. Using KBackup in a commercial environment requires
  426. obtaining a license from the author. Use of KBackup for private
  427. purpose is free of charge if you ``register'' your copy with a picture postcard.
  428. The exact conditions of use are stated in Appendix txt_copying.
  429.  
  430. Why register?
  431. Your benefits from registering KBackup (with a postcard) are that you will
  432. receive information about further development and bugfixes. The author will
  433. also try to give you as much support as possible.
  434.  
  435. It will also keep me motivated to continue this work, which takes an awful
  436. lot of time and energy. So, if you use KBackup, please register, either with
  437. a postcard or, if you use it commercially, by paying a registration fee.
  438. For details see the Appendix txt_copying.
  439.  
  440.  
  441.  
  442.  
  443.  
  444. Chapter:            Changes against prior versions
  445. =========================================================================
  446.  
  447.  
  448. Changelog
  449. =================================
  450.  
  451.  
  452. The remote device support is still mainly untested. I desperately need some
  453. feedback from people who try it in a real-word environment.
  454.  
  455.  
  456. Changes from 1.2.6 to 1.2.7
  457. =================
  458.  
  459.  
  460.  
  461.  *  fixed problems with incremental backups
  462.  *  put all temporary files into one common directory
  463.  *  added ttymode parameters for MultiBuf
  464.  *  added user definable parameters for tar/afio
  465.  *  fixed dirlist in ttymode
  466.  *  fixed parameter handling for afio 2.4.2
  467.  *  fixed redirection problem in restore-src
  468.  *  added working(!) configuration file for IOmega ZIPdrive
  469.  
  470.  
  471.  
  472.  
  473. Changes from 1.2.5 to 1.2.6
  474. =================
  475.  
  476.  
  477.  
  478.  *  manual still outdated
  479.  *  added <errno.h> to multibuf.c
  480.  *  improved logfile/contdir filtering in restore-src
  481.  *  fixed bugs in logfile handling, cont. dir handling during restore
  482.  *  mt should work on remote host as well now
  483.  *  eventually (!!!) got pgp and afio to work fine together (???)
  484.  *  pgp should work safe(!!!) now, by using input redirection
  485.  *  added protect-newer-files option for AFIO format
  486.  *  added support for afio 2.4.2 features (pgp)
  487.  *  changed kbinstall to support ttymode
  488.  *  created simple text mode for use without dialog (opt: --ttymode)
  489.  *  fixed typo in auto-rewind()
  490.  *  fixed tar specific problem with restore from contentsfile
  491.       (Do NOT use -s for tar restore operation!)
  492.  *  fixed problem with afio version detect
  493.  *  fixed problems with restore from contentsfile
  494.  *  created dialog-script to replace dialog program if not available
  495.  *  changed multibuf/Makefile
  496.  *  fixed Delete-Logfile() function
  497.  *  changed order of this file (was getting too long) :-)
  498.  *  fixed configuration of directory for temporary files
  499.  *  fixed logfile message in report generation
  500.  *  added report-msg for broken contents dir in verify
  501.  
  502.  
  503.     
  504.  
  505. Changes from 1.2.4 to 1.2.5
  506. =================
  507.  
  508.  
  509.  
  510.  *  multibuf seems to work with all types of tape drives now
  511.  *  made code more portable (if statements)
  512.  *  better handling of SIGINT
  513.  *  bug report can be saved to a file now
  514.  *  detection of configuration change and prompt whether to save it
  515.  *  included icons for HTML version of manual
  516.  *  cleaned up detection whether device is tape or not
  517.  *  changed Help-Menu text
  518.  *  added more info to MultiBuf Menu
  519.  *  added ``rewind''-warning
  520.  *  fixed ``mkfs''-bug
  521.  *  added report generation
  522.  *  added automatic verify for tape archives
  523.  *  changed KBackup directory hierarchy, made kbinstall move old files
  524.  *  fixed some minor bugs
  525.  *  clarified Shareware-Copyright notice
  526.  *  fixed sequence number problem in MultiBuf
  527.  *  some minor fixes on BLOCKDEV code
  528.  *  some fixes to code handling change of volumes
  529.  *  removed icons from HTML manual
  530.  
  531.  
  532.  
  533.  
  534. Changes from 1.2.3 to 1.2.4
  535. =================
  536.  
  537. In 1.2.3, the autodetection code was missing and there was a problem with
  538. multibuf on SCSI tapes as well as minor problems with the installation program.
  539. I hope to have them fixed in 1.2.4  (released Jan, 18, 1996).
  540.  
  541.  
  542.  
  543.  *     - added ``fmark-fix'' to multibuf: retries reading if 0 bytes read
  544.       (should?!? skip filemarks reliably on non QIC-02 tapes)
  545.  *     - added warning about erasing DAT drives
  546.  *     - fixed some bugs in kbinstall: writes proper pathnames to src/paths
  547.  *     - added missing autodetect-src to archive
  548.  
  549.  
  550.  
  551.  
  552. Changes from 1.2.0 to 1.2.3
  553. =================
  554.  
  555. Most of the changes are only minor improvements or bugfixes:
  556.  
  557.  
  558.  
  559.  *  fixed $findxpertflags= assignment
  560.  *  added lots of doublequotes in assignments to improve safety
  561.  *  minor changes to restore and verify routines to share common code
  562.  *  fixed bugs introduced by new doublequotes in read-data/write-data
  563.  *  made it able to autodetect and read non-multibuf archives (V1.0/V1.1 type)
  564.  *  (re-)added menu to switch off MultiBuf use 
  565.  *  fixed a few bugs in read-data/write-data
  566.  *  started work on improved afio
  567.  *  directory requester is sorting entries now
  568.  *  fixed a missing close() in multibuf.c
  569.  *  added last-command variable to be used by check-error
  570.  *  introduced common ``<'' key to go back to previous menu
  571.  *  made directory requester show symlinks
  572.  *  fixed Goto-Operation to handle archives with any count of files
  573.       on the tape --- important for mixing multibuf/non-multibuf archives
  574.  *  changed copyright to BSD like
  575.  
  576.  
  577.  
  578. New features that have been added, are:
  579.  
  580.  
  581.  *  first try at remote device support via rsh(1), works fine on my machine 
  582.  *  added autodetection/check tape & restructured device menu
  583.  
  584.  
  585.  
  586.  
  587. Changes from 1.1 to 1.2.0
  588. =================
  589.  
  590. Among them
  591.  
  592.  
  593.  *  fixed the directory--exclusion bug, completely rewrote routines for
  594.     including/excluding  files
  595.  *  added pattern matching capabilities
  596.  *  created MultiBuf, giving automatic end-of-tape detection
  597.  *  started modularising the software for faster start up (this also
  598.     enables you to save disk space by leaving out unnecessary options,
  599.     important for rescue--disks)
  600.  *  fixed code for verifying archives
  601.  *  restructured menus
  602.  *  KBackup now handles filenames containing whitespace properly
  603.  *  support for mountable block devices
  604.  *  improved installation program
  605.  *  changed archive formats (sorry)
  606.  
  607.  
  608.  
  609. Chapter:            Backups
  610. =========================================================================
  611.  
  612.  
  613. Creating a backup
  614. =================================
  615.  
  616.      is rather simple.
  617.     Make sure that you have set the 
  618.      
  619.     parent
  620.     directory for your backup to the directory whose contents you
  621.     want to back up (You can set this in the Configuration--menu. Then select Backup in the main menu.
  622.  
  623.     If all the options are set to proper values, this will work.
  624.     Easy, isn't it? :-)
  625.  
  626. Backup types
  627. =================================
  628.  
  629. In principal, there are two different classes of backups. Full backups
  630. .
  631. During a full backup, all files specified get backed up, while in an
  632. incremental backup you will only find those files modified after a
  633. certain date or time. This usually is the date and time of the last
  634. backup. Doing incremental backups can save you lots of time and space on
  635. your backup medium, but for a full restore you will always need the
  636. first full backup as well as all incremental backups. So better do a full
  637. backup from time to time or you might run into trouble.
  638.  
  639. There is no difference between normal and multivolume
  640. backups. All backups are handled by the MultiBuf program.
  641.  
  642.  
  643. Incremental backups
  644. =================================
  645.  
  646.  
  647. txt_incremental
  648. To save only the files that are newer than a given date and time, KBackup
  649. provides incremental backups. In the Configuration/File selection--menu
  650. you can set the date to compare the files to. Whenever
  651. you create a backup using the same configuration, this date gets set
  652. to the current time.
  653. If you make a backup using the configuration ``Default'', this does not affect 
  654. the date for the configuration ``Example'' and so on.
  655.  
  656. Caution:
  657. Using incremental backups can lead to inconsistencies! After restoring them,
  658. all files get written back to the filesystem, but files that have been deleted
  659. intensionally will get rewritten as well. Therefore you will generally have
  660. more files than before which might cause unexpected behaviour from some
  661. applications, especially if you restore lock--files. If you can, better do full
  662. backups.
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672. Chapter:            Restoring backups
  673. =========================================================================
  674.  
  675.  
  676. Restoring Backups
  677. =================================
  678.  
  679. For restoring backups it is important to understand
  680. that the files get restored relative to the current parent
  681. directory parent directory. For this reason you are prompted 
  682. to change or confirm it before any files get restored. The original
  683. parent directory under which the contents of the archive were located
  684. at the time the backup was made, is used as the default; so you do not
  685. need to remember it by yourself.
  686.  
  687.  
  688. Selecting files for Restore operation
  689. =================================
  690.  
  691. Before restore operation starts    you can choose between several
  692. options.
  693.  
  694.  
  695. Restore all files from archive
  696. =================
  697.  
  698. This does just what you expect from it. It restores the complete
  699. archive. If any of the files do already exist, they get overwritten.
  700.  
  701.  
  702. Initialise editable list of files from contents directory
  703. =================
  704.  
  705. This reads in the  contents directory from the
  706. archive (if it is not a simple floppy archive) and lets you edit this list. You can
  707. then manually remove all files that you do not want to restore. After you
  708. save the file and exit your editor, those files remained in the list
  709. will get restored.
  710.  
  711.  
  712. Initialise editable list of files from log file
  713. =================
  714.  
  715. This is like the operation described above, but instead of initialising
  716. the list from the contents directory, it gets initialised from a
  717. log file. 
  718.  
  719.  
  720.  
  721. Chapter:            Other Actions
  722. =========================================================================
  723.  
  724.  
  725. Tape Operation
  726. =================================
  727. --Menu
  728. All functions from this menu operate on tape drives only. They do not
  729. make any sense on archive files or floppy drives.
  730.  
  731. Most of them are simply a front end to the  mt(1) command.
  732.  
  733.  
  734. Rewind Tape
  735.  
  736. Obviously, this will rewind your tape.
  737.  
  738.  
  739. Try to Reset Tape Driver
  740.  
  741. This will try to read from the filename given for resetting tape drives.
  742.  
  743. Such a device is only implemented for the QIC-02 driver and
  744. it is usually called ``/dev/tape-reset''.
  745.  
  746. If your QIC-02 drive does no longer seem to work, this might help.
  747.  
  748.  
  749. Go to n-th Backup on Tape
  750.  
  751. This will wind the tape to the beginning of a specified backup. 
  752.  
  753. Note: This does not go to the n--th
  754. file, but to the n--th backup! It can handle
  755. backups with and without sequence information mixed in any order on
  756. one medium. This will not work properly with backups written by
  757. other programs!
  758.  
  759.  
  760. Go to End of Written Data
  761.  
  762. This will wind the tape to the end of written data, for appending data
  763. to a tape without overwriting its contents.
  764.  
  765.  
  766. Erase Tape
  767.  
  768. This will erase the whole tape. 
  769.  
  770.  
  771. Retension Tape
  772.  
  773. This will wind the tape to its end and back to its beginning to
  774. retension it.
  775.  
  776.  
  777.  
  778. Set tape offline: rewind and unload it
  779.  
  780. This will issue the mt offline command to the tape device. On devices
  781. that support this, it will cause the tape cartridge to be rewound and unloaded.
  782.  
  783.  
  784.  
  785. Other Actions
  786. =================================
  787.  
  788. This section describes the other options from the
  789. Actions--menu.
  790.  
  791.  
  792. Verify Backup
  793.  
  794. This will try to verify a backup. It also shows valuable information
  795. about the backup type, date  -- everything it finds in the
  796. backup's header.
  797.  
  798.  
  799.  
  800. Get Backup Size
  801.  
  802. This estimates the amount of media space required for doing a backup
  803. with the current settings. 
  804. It simply adds up the file sizes of all files specified for backup. 
  805. The size given is the uncompressed size of the backup, if using
  806. compression you can roughly expect it to be half or one third as big.
  807.  
  808.  
  809.  
  810. View Archive Contents
  811.  
  812. This will show an archive's contents directory, or if nonexistent, will
  813. generate a list of files in the archive.
  814.  
  815.  
  816. View a Log file
  817.  
  818. This shows you a list of all log files and you can
  819. view them. 
  820.  
  821.  
  822. Delete a Log file
  823.  
  824. This shows you a list of all log files and you can
  825. delete one of them.
  826.  
  827.  
  828. Send a Bug Report
  829.  
  830. To mail a bug report  to the
  831. authormail://Karsten.Ballueder@stud.uni-karlsruhe.de
  832. of KBackup, you
  833. should use this function. It will create a list of the configuration
  834. settings and collect some information about your system's setup and
  835. prompt you to fill in a bug report which subsequently will get mailed to
  836. me. Of course, this can also be used for suggestions how to improve
  837. KBackup! :-)
  838.  
  839.  
  840.  
  841. Chapter:            Scheduling Backups
  842. =========================================================================
  843.  
  844.  
  845. Introduction
  846. =================
  847.  
  848.     KBackup offers you the possibility to schedule a backup or
  849.     restore operation to be executed automatically (by using
  850.     the at(1) command) at any later time.
  851.  
  852.     For scheduled operation to work properly, you need to have
  853.     the crond(8) -- demon running. Also the at(1)
  854.     program
  855.     needs to be available and a suitable entry be in your crontab(1) file. This should be the case on any properly installed
  856.     system, so do not worry about it unless you get error messages.
  857.  
  858. By setting the commands to execute by MultiBuf, you can even support
  859. automatically changing tapes if your hardware supports this.
  860. If you do so, I'd appreciate if you could tell me about it.
  861.  
  862. The Scheduling
  863. =================
  864. --Menu
  865.  
  866.  
  867. Set date and time
  868.  
  869.     Here you can set the date and time at
  870.     which to execute the operation in a format suitable for the
  871.     at(1) command. See its man-page for details.
  872.  
  873.  
  874. Schedule a backup
  875.  
  876.     After choosing the Schedule Backup function, KBackup terminates
  877.     and will perform the backup at the time specified.
  878.     
  879.  
  880.  
  881. Schedule a restore
  882.  
  883.     After choosing the Schedule Restore option, KBackup first
  884.     needs to read some information from the archive, so it must
  885.     already be available. Further on you get prompted the usual
  886.     Restore options. Then KBackup terminates and the files specified 
  887.     will get restored when their time has come.
  888.     
  889.  
  890.  
  891. Toggle Once Only flag
  892.  
  893. Normally, after having performed the scheduled operations,
  894. KBackup will automatically remove the temporary configuration
  895. files
  896.  
  897. that it had created for this purpose.
  898.  
  899. If you schedule KBackup to run more than once, e.g. every night,
  900. youu must activate this flag, so it will keep the configuration
  901. files required for scheduled operation.
  902.  
  903.  
  904.  
  905. Chapter:            Configurations
  906. =========================================================================
  907.  
  908.  
  909. The r^ole of Configurations
  910. =================================
  911.  
  912.  
  913. When you want to create a backup, you are confronted with lots of
  914. options that affect which files get included, the way the archive is written, compressed or
  915. whatever. Instead of having you set these options manually whenever you
  916. write a backup, KBackup lets you create named configurations. 
  917.  
  918. For example, you can set all the options and the parent
  919. directory parent directory to back up your home--directory in
  920. a compressed archive to tape. Now you save these settings under a name
  921. (e.g. ``Home''). Whenever again you want to make a backup of your home
  922. directory, all you have to do is enter the Configuration--menu
  923. and load the configuration ``Home''. This will automatically restore the
  924. settings you had chosen.
  925.  
  926. When using  incremental backups, the
  927. configuration gains some more importance. The date and time to compare
  928. the files to while creating the incremental backup, are dependent on the
  929. actual configuration. So making a backup with the configuration ``A'' does
  930. not affect the date and time for incremental backups using configuration
  931.  ``B''.
  932.  
  933.  
  934. How to create a Configuration
  935. =================================
  936.  
  937. That is pretty simple. Just set all options and parameters in the
  938. Configuration--menu as you like them and then choose Write
  939. a Configuration File from it. You will then be prompted a name for
  940. it.
  941.  
  942.  
  943. Load a Configuration
  944. =================================
  945.  
  946. If you choose the Load a Configuration entry from the
  947. Configuration--menu, you will be shown a list of available
  948. configurations.
  949.  
  950.  
  951. Where to start?
  952. =================================
  953.  
  954. When you install KBackup for the first time, it will create some
  955.  
  956. example configurations for you. Try modifying these to fit your situation.
  957.  
  958.  
  959. Configuration Default
  960. =================
  961.  
  962.  
  963.  
  964.  
  965. This is a configuration for using tapes. It assumes that you have a link called
  966. /dev/tape pointing to a non-rewinding tape device. It is a good starting
  967. point for creating your own configurations.
  968.  
  969. Configuration Floppy-and-Blockdevices
  970. =================
  971.  
  972.  
  973.  
  974.  
  975. If you want to use floppy disks, this is the configuration to use. It will not
  976. write straight to the device but create a filesystem on it and write to that.
  977. This is safer than writing straight to the device. This configuration can 
  978. easily be adopted for use with removable hard drives.removable
  979. hard-drives
  980.  
  981. Configuration ZIPdrive
  982. =================
  983.  
  984.  
  985.  
  986. This configuration file has been sent to me by a user who uses an IOmega
  987. ZIPdrive(TM)$. Try whether it works for you. It has not been tested with
  988. multiple volumes yet. 
  989.  
  990. Chapter:            Option settings
  991. =========================================================================
  992.  
  993.  
  994. Command Line Options
  995. =================================
  996.  
  997. There is only one command line option intended to be used manually:
  998.  
  999.  
  1000. This will cause KBackup to run in ``tty--mode'', not using the
  1001. dialog(1) program, while still offering full functionality.
  1002. Generally this will not be needed, but it might be helpful in
  1003. debugging (e.g. using script(1)), for porting it to other
  1004. systems but Linux and for creating a boot disk without the rather big
  1005. dialog(1) binary.
  1006.  
  1007. If dialog(1) is not installed on your system, KBackup will
  1008. detect this and automatically start up in ``tty--mode''.
  1009.  
  1010. Well, in fact, there are some other options, but they are not meant to be used
  1011.     by you. In order to recognise what to do when called in scheduled operation mode, atrun(8) calls it with some options.
  1012.     You might, however , use them to perform a scheduled operation if your at(1)/crond(8) does not work. Have a look at 
  1013.     the source to see what they do.
  1014.  
  1015.     (e.g. kbackup --scheduled-backup .--scheduled--1234 to perform the scheduled backup number
  1016.     1234)
  1017.     
  1018.  
  1019.  
  1020. Options set from within KBackup
  1021. =================================
  1022.  
  1023.  
  1024. All configuration settings are done within KBackup. You reach them by
  1025. selecting the Configuration--menu.
  1026.  
  1027.  
  1028.  
  1029. Set Parent Directory
  1030.  
  1031. This allows you to set the parent directory for all
  1032. backup operations. If you do a backup, only files under this
  1033. directory are seen. If you restore from an archive, the
  1034. files get positioned relative to this path.
  1035.  
  1036.  
  1037. If you want to make a backup of your ``/home'' directory tree
  1038. only, set this to be your parent directory. So KBackup will back up
  1039. only these files.
  1040. %
  1041.  
  1042. Configuration
  1043. --Menu
  1044. %
  1045. This gets you to the Configuration--menu, where you can
  1046. configure the way KBackup behaves.
  1047.  
  1048.  
  1049. Set File Selection Parameters
  1050. --Menu
  1051. All settings that can be made in this menu work together to decide
  1052. which files will get backed up and which won't. See the next section
  1053. for more details.
  1054.  
  1055.  
  1056. Configure KBackup--Menu
  1057.  
  1058. In this menu you can set options that influence the way KBackup
  1059. works, like  archive format, compression, 
  1060.  
  1061.  
  1062. Write a Configuration File
  1063.  
  1064. Do I really need to explain this? Just give a name for this
  1065. configuration. 
  1066.  
  1067.  
  1068. Load a Configuration File
  1069.  
  1070. You will see a list of configurations. Choose one.
  1071.  
  1072.  
  1073.  
  1074. Delete a Configuration File
  1075.  
  1076. You will see a list of configurations. Choose one to delete it.
  1077.  
  1078.  
  1079.  
  1080. Set File Selection Parameters
  1081. =================
  1082. --Menu
  1083.  
  1084.  
  1085. Toggle Local Filesystem Mode
  1086.  
  1087.     If set to YES, KBackup will backup only files within one
  1088.     filesystem. If you want to backup a whole directory tree with
  1089.     all volumes mounted within, you must set this to NO.
  1090.     
  1091.     
  1092.  
  1093. Toggle Incremental Mode
  1094.  
  1095.     If set to YES, backup only files that have been changed after
  1096.     the date given.
  1097.     See section txt_incremental for more information.
  1098.  
  1099.  
  1100. Set Date For Incremental Backup
  1101.  
  1102.     If in incremental mode, KBackup will only backup files that
  1103.     are newer than this date. Here you can change it. This date
  1104.     gets updated every time you perform a backup with the same
  1105.     configuration. 
  1106.  
  1107.  
  1108.  
  1109. Edit List of Files to Exclude
  1110.  
  1111.  
  1112.     There are always some files you do not want to include in a
  1113.     backup.  Examples might be:
  1114.     proc, dev, home/fred/secrets
  1115.  
  1116.     Give their names relative to the parent directory and list
  1117.     them one per line. See the default entries for more examples.
  1118.     Lines beginning with a ``#'' are ignored and can
  1119.     be included as comments. This list gets interpreted
  1120. always, no matter whether you use pattern matching or not.
  1121.  
  1122.  
  1123.  
  1124.  
  1125.     
  1126. minipage0.8
  1127. An example:
  1128. You have set your parent directory to ``/home'', and the
  1129. exclude list contains the entries:
  1130. fred/secrets
  1131. guest
  1132. This will backup all files of the ``/home''--tree, except for
  1133. the trees ``/home/guests'' and ````/home/fred/secrets''.
  1134. minipage
  1135.  
  1136.  
  1137.  
  1138.  
  1139. Set shell pattern for files to exclude
  1140.  
  1141.  
  1142. Instead of listing all files to exclude from the backup separately,
  1143. you can exclude files by using the shell's pattern matching rules. By
  1144. using expressions like e.g. ``*.log'', you can exclude all
  1145. files matching this pattern. 
  1146.  
  1147. In the list, patterns must be specified one at a line. Lines starting
  1148. with ``#'' are ignored and can be used for comments. For the patterns
  1149. to take effect, they must be explicitly activated.
  1150.  
  1151.  
  1152. Set shell pattern for files to include
  1153.  
  1154.  
  1155. Like using shell pattern matching to exclude files from the backup,
  1156. you can also specify a pattern for the files to include. The
  1157. standard setting should be ``*''. Do not leave this
  1158. empty when using pattern matching!
  1159. A useful(?) example of this would be to backup only your TeX--files, by
  1160. specifying ``*.tex''.
  1161.  
  1162.  
  1163. Toggle use of exclude/include patterns
  1164.  
  1165.  
  1166.  
  1167.  
  1168. txt_toggle_patterns
  1169. With this switch you decide whether KBackup uses the exclude and
  1170. include patterns or not. Usually this is switched off so the patterns
  1171. get ignored. This does not influence interpretation of the list of
  1172. files to exclude. 
  1173.  
  1174.  
  1175. Protect newer files during restore
  1176.  
  1177. This will cause KBackup to restore only files that have not been
  1178. changed since the backup was made, thus protecting any files that are
  1179. newer than the backup from being overwritten.
  1180.  
  1181.  
  1182.  
  1183. Set Advanced Options
  1184. --Menu
  1185. This menu gives you deeper control about the way KBackup looks at
  1186. your files. Normally you will not need to use it.
  1187.  
  1188.  
  1189. Configure KBackup
  1190. =================
  1191. --Menu
  1192.  
  1193. In this menu you find the settings that control KBackup's operation,
  1194. apart from file selection.
  1195.  
  1196.  
  1197. Create Report on Backup
  1198.  
  1199.  
  1200. This leads to an input box where you can specify a command for
  1201. handling report files. If you leave this empty any reports will be
  1202. discarded. Otherwise, KBackup will create a detailed report during
  1203. backup operation and process it with this command. It can for example
  1204. be used to print a report to store it with your backup medium, or to
  1205. mail the report to the system administrator.
  1206.  
  1207.  
  1208. Set Name of Editor to use
  1209.  
  1210. If you do not have your EDITOR environment variable set
  1211.  
  1212.  and
  1213. do not like the standard setting (vim(1), the ``vi--improved''
  1214. Apparently, there is a problem with vi(1) that occasionally
  1215. makes it unusable from within KBackup. All other editors I use work fine., just tell KBackup 
  1216. about your favourite editor. If you like the feeling of
  1217. DOS--editors, try  using joe(1).
  1218.  
  1219.  
  1220. Follow Backup/Restore--Process on Screen
  1221.  
  1222. This will show you file by file how KBackup processes the archives. 
  1223.  
  1224.  
  1225.  
  1226. Toggle use of restore--log file
  1227.  
  1228.  
  1229. With this switch you can decide whether KBackup creates a log file
  1230. during restore operation. Disabling log file creation can be useful
  1231. when disk space is few, like e.g. when running from a floppy disk.
  1232.     
  1233.  
  1234. Set Compression/Encryption Mode
  1235.  
  1236.  
  1237.     Here you can choose whether you want to compress or encrypt
  1238.     your archives. You can use either compress(1), gzip(1) or
  1239.     pgp(1).
  1240.  
  1241.     In the menu for choosing the compression/encryption filter
  1242.     you can also pass any useful command line options to the filter. 
  1243.     A rather useful one is the parameter "-1" for gzip(1). 
  1244.     A gzip-compressed file with option "-1" is about 10--20%
  1245.     larger than with the standard compression, but compressing it
  1246.     is about twice as fast. 
  1247.  
  1248.     Do not be surprised, compressing a long backup can take quite
  1249.     some time (during which your tape might not operate if you are using
  1250.     double-buffering).
  1251.  
  1252.     A word about encryption:
  1253.     You can use pgp(1) public--key encryption with both,
  1254.     tar(1) and afio(1). Using afio(1) is
  1255.     highly recommended, unless your archives will be small.
  1256.     Using tar(1) together with pgp(1) encryption limits
  1257.     your maximum size for archives to the free disk-space in your
  1258.     temporary directory. 
  1259.  
  1260.     When using encryption, you will be prompted for a default
  1261.     pass-phrase  when-ever you try to read the
  1262.     archive.  This will temporarily get stored in a file
  1263.     unreadable for others. 
  1264.     If you leave it empty, pgp(1) will prompt you
  1265.     for the pass-phrase again and again with every singe file it
  1266.     decrypts. Please, do read the pgp(1) manual page
  1267.     and documentation before using it!
  1268.  
  1269. There is also a problem with old versions of afio(1) and pgp(1): If the
  1270. encrypted file is bigger than the original one, current versions of
  1271. afio(1) will store it unencrypted! So check your logfiles
  1272. carefully when using encryption. Please use at least
  1273. afio(1) version 2.4.2 when using encryption.
  1274.  
  1275.     For legal reasons, I cannot include pgp(1) with
  1276. KBackup. Its several versions are available from ftp--servers all
  1277. over the world, e.g. from ftp.th-darmstadt.de
  1278. ftp://ftp.th-darmstadt.de/pub/security/pgp.
  1279.  
  1280.  
  1281. Toggle Use of Double Buffering
  1282.  
  1283.  
  1284. If your machine is slow or heavily loaded or if your tape drive is too fast,
  1285. it will start and stop the tape every now and then. This is unhealthy
  1286. for both, the tape and the drive. To avoid repeated starts and stops of the
  1287. drive, you can use double-buffering. By collecting a large buffer of
  1288. data and writing it at once, you reduce the number of starts and stops.
  1289.  
  1290.  
  1291.  
  1292. This is extremely useful when using compression or encryption because
  1293. these operations reduce data throughput. However, you will see how your
  1294. tape drive performs without double-buffering and then you can decide
  1295. whether to use it or not. 
  1296.  
  1297.  
  1298. Set Memory Size for Double Buffering
  1299.  
  1300.  
  1301. Here you can set how big a buffer to use for double-buffering. To get a good
  1302. effect, use a large buffer of several megabytes.
  1303. Specify either the number of bytes, or use
  1304. the affixes ``k'' or ``m'' to specify Kbytes or Mbytes.
  1305.  
  1306. A value of 4--8~Mbytes usually works very well, even on a slow
  1307. mashine. 
  1308.  
  1309.  
  1310. Verify Archives After Writing
  1311.  
  1312.  
  1313. If this option is set, KBackup will try to verify the archive while or
  1314. immediately after writing it. When using floppies
  1315. , you should activate this.
  1316. On tapes, this will not work (it is physically impossible), so you
  1317. have to verify your tape archives manually, using the
  1318. Actions/Verify--function.
  1319.  
  1320.  
  1321. Archive Type Menu
  1322.  
  1323. Here you choose which archive type to use. KBackup uses either 
  1324. tar(1)--format or afio(1)--format. 
  1325. See section txt_archive_type_menu for more.
  1326.  
  1327.  
  1328. Change KBackup Directory
  1329.  
  1330. Here you tell KBackup in which directory 
  1331. to store its configuration files and log files. The default place is
  1332. /var/adm/KBackup.
  1333.  
  1334.  
  1335.  
  1336.  
  1337. Select device for backup
  1338. --Menu
  1339. In this menu you can select which device to use for your backups.
  1340. It is also being used to tell KBackup how to treat the device,
  1341. whether as a tape, a simple floppy disk or a mountable blockdevice.
  1342.  
  1343.  
  1344. Remote mode settings
  1345. --Menu
  1346.  
  1347. This is for the (still experimental) support for accessing remote backup devices,
  1348. that is, devices of another machine. The way it works is very similar
  1349. to the rmt(8) demon. KBackup will call a remote shell and
  1350. redirect the data to a MultiBuf process running on the remote
  1351. machine. 
  1352.  
  1353. On the remote machine, at least MultiBuf, dd(1) and the archive
  1354. handler (afio(1) or tar(1)) have to be installed. It is
  1355. best, if you install the complete KBackup package on both machines to
  1356. make sure everything is available.
  1357.  
  1358.  
  1359. Toggle use of remote mode
  1360.  
  1361. To choose whether to use remote access or not. Usually switched off.
  1362.  
  1363.  
  1364. Set hostname to connect to
  1365.  
  1366.  
  1367. Here you must specify the machine that hosts the backup device.
  1368.  
  1369.  
  1370. Set user to use for login
  1371.  
  1372. For logging in to the remote machine, KBackup needs a user id. This
  1373. user must have access to the backup device and the relevant programs.
  1374.  
  1375.  
  1376.  
  1377. Verify whether settings work
  1378.  
  1379. This will try to access the remote device to check whether your option
  1380. settings work.
  1381.  
  1382.  
  1383.  
  1384. Multivolume Archives handling
  1385. --Menu
  1386. In this menu you can set options related to the MultiBuf program
  1387. which is responsible for handling multivolume archives. It does however handle
  1388. all archives, so better have a look at the relevant section
  1389. (txt_multibuf).
  1390.  
  1391. Usually, you should not change any of these options. If you encounter problems
  1392. with the MultiBuf program, you can disable its use here. In that case you 
  1393. should also send a bug report to the author.
  1394.  
  1395.  
  1396. Set Directory for Temporary Files
  1397.  
  1398. Here you set in which directory 
  1399. KBackup stores temporary files. This should point to your
  1400. "/tmp" directory.
  1401.  
  1402.  
  1403. Set command for viewing online manual
  1404.  
  1405. Here you can specify the command to use for displaying the online
  1406. versions of this manual. Depending on your taste this can be
  1407. set to use the plain text version or a hypertext browser for the HTML version.
  1408.  
  1409.  
  1410. Select device for backup
  1411. =================
  1412. --Menu
  1413. In this menu you can select which device to use for your backups.
  1414. You can either choose one device from the menu or specify your own
  1415. file name. This does not install any driver! You need to have a
  1416. driver for your device in your kernel, so KBackup can talk to its
  1417. device file.  
  1418.  
  1419. You can also choose between
  1420. different ways of how to treat the device. KBackup
  1421. currently supports three different ways of archive treatment, which
  1422. can be set with the Set Device Type--option:
  1423.  
  1424. The new  floppy driver supports high volume floppy formats of up
  1425. to about 1.9~MB per 3.5'' HD floppy, or 3.8~MB per 3.5'' ED floppy. If
  1426. the corresponding entries are set in your /etc/fdprm file,
  1427. they can be used from KBackup.
  1428. It will automatically call the setfdprm(1) program for you.
  1429. For more information on  floppy formats, see the documentation
  1430. of the fdutils--package, available from:
  1431. ftp://sunsite.unc.edu/pub/Linux/system/Misc/fdutils-4.1.lsm
  1432.  
  1433.  
  1434. Attempt to autodetect tape device
  1435.  
  1436. This option requires a tape cartridge in your tape device and will
  1437. scan your system for valid tape devices and try to find out the one
  1438. to use with KBackup. This should solve the problems of all those
  1439. people who tried using KBackup with a rewind-on-close device.
  1440. After examining your system, KBackup will prompt you with a list of
  1441. usable devices.
  1442. autodetect tape
  1443. device
  1444.  
  1445. Caution: This will write to the tape and
  1446. overwrite any data on it! 
  1447.  
  1448.  
  1449. Check tape drive for compatibility
  1450.  
  1451. This will check the currently selected device for compatibility with
  1452. KBackup, that is, it will verify that it is a non-rewind-on-close
  1453. device.
  1454.  
  1455. If you cannot read your archives properly, check your device with this
  1456. function. Caution: This will write to the tape and overwrite
  1457. any data on it!
  1458.  
  1459.  
  1460. Set device type
  1461.  
  1462.  
  1463. txt_mountable_blkdev
  1464. With this switch you can toggle between different ways of treating the
  1465. device. You can choose between TAPE, FLOPPY and
  1466. BLOCKDEV.
  1467.  
  1468.  
  1469.  * 
  1470. TAPE:
  1471. This should be selected when you are writing to a tape device.
  1472.  
  1473.  * 
  1474. BLOCKDEV:
  1475.  
  1476. This format is new since KBackup Version 1.2. With this setting,
  1477. KBackup will format and mount the device and then start writing to
  1478. it. This gives you all the advantages of KBackup, like a backup
  1479. header with information about the backup and the contents directory,
  1480. together with a much improved reliability compared to the
  1481. FLOPPY--format. If you are using floppy disks with this
  1482. option, you must low-level format them, using the
  1483. fdformat(1) or  superformat(1) commands (under ).
  1484.  
  1485. You do not need to write a filesystem on it, this will be done by KBackup.
  1486. When selecting this option, you also must set the filesystem type and
  1487. the formatting command.
  1488.  
  1489. I recommend using this format for any removable media, like floppies
  1490. or removable hard-drives
  1491. e.g. the IOmega ZIPdrive
  1492. or cartridges. It does not work with
  1493. tapes, it is intended for block devices that can be mounted.
  1494.  
  1495.  
  1496.  
  1497. The BLOCKDEV support was new in version 1.2.0 and is therefore
  1498. less tested than TAPE of FLOPPY. If you should expect any trouble
  1499. using it, please contact the author. If it works for you, I'd like to
  1500. know as well. 
  1501.  
  1502.  * 
  1503. FLOPPY:
  1504. With this option, KBackup writes directly to the floppy. This is most
  1505. reliable when you are using afio(1) -- better do not try to use
  1506. tar(1) with floppies. However, writing straight
  1507. to a floppy is not to safe under  and there is no way for
  1508. KBackup to write a header or a directory of contents to the
  1509. floppy. So you just have a sequential archive, like when using
  1510. afio(1) directly.--format
  1511.  
  1512. However, using this format is not recommended, better use the
  1513. BLOCKDEV--format which is more reliable. 
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519. Enter your own device/archive file
  1520.  
  1521. Here you can enter a device name of your own choice.
  1522.  
  1523.  
  1524. /dev/fd0 and /dev/fd1
  1525.  
  1526. Select the first or second floppy drive for your backups.
  1527.  
  1528.  
  1529.  
  1530. Blockdev filesystem type
  1531.  
  1532. This is only of interest, if you are using the BLOCKDEV
  1533. device type.
  1534.  
  1535. Here you need to specify the filesystem type that
  1536. you want to use on mountable  block devices. See the following section
  1537. for more details and a discussion of which filesystem  to use.
  1538.  
  1539.  
  1540. Blockdev make  filesystem command
  1541.  
  1542. This is only of interest, if you are using the BLOCKDEV
  1543. device type.
  1544.  
  1545. Before using any medium, KBackup will issue this command to make a
  1546. filesystem on it.  This filesystem must  be the same
  1547. as specified in the Blockdev filesystem type, otherwise
  1548. KBackup cannot mount the device.
  1549.  
  1550. When using floppy disks, you can low-level format them and make a
  1551. filesystem on them in one step, like e.g. this:
  1552. verbatim
  1553. fdformat /dev/fd0H1440 && mkfs -t minix /dev/fd0H1440 1440
  1554. verbatim
  1555. Instead of specifying the device name directly, you can use
  1556. ``!$device!'', which will get replaced by the actual device
  1557. name.
  1558.  
  1559. For floppy disks, I recommend using the
  1560. ``minix'' filesystem because it gives you the biggest
  1561. capacity.  If you are using superformat(1) instead of
  1562. fdformat(1), you can write up to 1.9~Mb onto a single HD floppy
  1563. disk.
  1564.  
  1565. For other media, you should probably use the  ``ext2''
  1566. filesystem which is the most advanced and secure one available under .
  1567.  
  1568.  
  1569. Set floppy format
  1570. --Menu
  1571. In this menu you can choose a  format for your floppy
  1572. disks. Warning: this setting will not get checked before it is
  1573. actually used, it must be a valid entry  from your
  1574. ``/etc/fstab'' file which will be set using the
  1575. setfdprm(1) command. 
  1576.  
  1577.  
  1578. Set device for resetting driver
  1579.  
  1580. If your tape driver implements a device to reset the driver, like
  1581. e.g. the QIC-02 driver does, you can set its name here. For the QIC-02
  1582. driver, this is /dev/tape-reset.
  1583.  
  1584.  
  1585. Remote mode settings
  1586. =================
  1587. --Menu
  1588.  
  1589. What is it?
  1590.  
  1591.  
  1592. The remote mode is still experimental and further development of it depends 
  1593. heavily on your feedback. I have very limited possibilities to test 
  1594. this and so I desperately need your experience with it.
  1595.  
  1596. With the remote mode enabled, you can access another computer's devices for
  1597. use with KBackup. IMPORTANT: On the remote computer, MultiBuf
  1598. must be installed, or the remote mode won't work. It ist best, to
  1599. install the complete KBackup on both machines, including also the tools used
  1600. by it.
  1601.  
  1602.  
  1603. Toggle use of remote mode
  1604.  
  1605. Normally, this is set to ``NO'', so to access your local devices.
  1606. If set to ``YES'', KBackup will try to access the devices on the remote host.
  1607.  
  1608.  
  1609.  
  1610. Set hostname to connect to
  1611.  
  1612. Set this to the name of the host, who's backup device you want to access.
  1613.  
  1614.  
  1615.  
  1616.  
  1617. Set user to use for login
  1618.  
  1619.  
  1620. Here you have to specify the username to use for logging in to the remote host.
  1621. This user must have access to the backup device and must not be prompted for
  1622. a password, which can be arranged by setting up a .rhosts or an
  1623. /etc/hosts.equiv file.
  1624.  
  1625.  
  1626. Verify whether settings work
  1627.  
  1628. This will try to log on to the remote computer using the settings specified
  1629. in the menu. If it is successful, a backup will be likely to succeed as well.
  1630. If not, you have no chance to write a backup, so you need to change your
  1631. settings.
  1632.  
  1633.  
  1634. Archive Type Menu
  1635. =================
  1636.  
  1637. txt_archive_type_menu
  1638. Here you choose which archive type to use. KBackup uses either 
  1639. tar(1)--format or afio(1)--format. 
  1640.  
  1641. tar(1) has been around since the early days of  , while
  1642. afio(1) is  newer and not installed on every system. 
  1643. The advantage of afio(1) is that it is smarter about corrupted
  1644. archives, so if you have a read error somewhere in your backup, it
  1645. will still continue and recover as many files as possible, while
  1646. tar(1) would just abort. Further on afio(1) does
  1647. compression file by file which is highly recommended for reasons of
  1648. safety. The default format is AFIO.
  1649.  
  1650.  
  1651. Use Afio
  1652.  
  1653. Obviously, this makes KBackup use afio(1) for handling archives.
  1654.  
  1655. Use Tar
  1656.  
  1657. Obviously, this makes KBackup use tar(1) for handling archives.
  1658.  
  1659. Set additional command line parameters for Afio
  1660.  
  1661. This allows you to pass additional command line parameters to
  1662. afio(1). KBackup by defaults sets this to -T 3k to
  1663. compress only files which are larger than at least 3 kbytes.
  1664.  
  1665. Set additional command line parameters for Tar
  1666.  
  1667. This allows you to pass additional command line parameters to
  1668. tar(1).
  1669.  
  1670.  
  1671. Advanced Options
  1672. =================
  1673. --Menu
  1674. txt_adv_opt
  1675. The options in this menu deeply affect the operation of KBackup. You
  1676. should know what you are doing before making any changes. 
  1677.  
  1678.  
  1679. Backup Only Files Specified
  1680.  
  1681.     If set to ``YES'', KBackup will only backup those files that are
  1682.     specified in the list of files to include, that you can
  1683.     edit from within the Advanced Options--menu.
  1684.  
  1685.  
  1686. Edit List of Files to Include in Backup
  1687.  
  1688.  
  1689. If you have activated the option to backup only the files specified, you
  1690. can use this menu entry to edit the list. A typical situation is when
  1691. you want to save several complete directory trees at once. The list of
  1692. files might then look like this:
  1693. verbatim
  1694. /etc
  1695. /home
  1696. /usr/local
  1697. verbatim
  1698.  
  1699.  
  1700. Initialise List of Files to include
  1701.  
  1702. This creates a default list of files, based on the other selection criteria.
  1703.  
  1704.  
  1705. Set Find Expert Mode
  1706.  
  1707.     Well, if you know about the many options of find(1), you can
  1708.     activate this option and use the following one to give the
  1709.     options find(1) will use to generate the list of files to
  1710.     back up.
  1711. Warning: If you activate this, all other options about file
  1712. selection will get ignored! The shell patterns and include/exclude
  1713. lists will not get interpreted either.
  1714.  
  1715.  
  1716. Set Find-Options
  1717.  
  1718.     If the option above this one is active, you can set 
  1719.     the options to use with find(1).
  1720.  
  1721.  
  1722. Set Option to Manually Edit List of Files
  1723.  
  1724.     If this is set to ``YES'', before doing a backup,
  1725.     KBackup will present you a list of files and let you edit
  1726.     it. Only the files remaining in the list will get processed.
  1727.  
  1728.  
  1729. Toggle Directories--Only Flag
  1730.  
  1731.     If set to ``YES'', the log files will only show directories, not
  1732.     the actual files. The same applies for the list of files you
  1733.     can edit before backing up or restoring. By setting this
  1734. option, you can significantly reduce the size of your logfiles or
  1735. contents directories.
  1736.  
  1737.      Usually, this
  1738. should be set to ``NO''.
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759. Chapter:            The MultiBuf Program
  1760. =========================================================================
  1761.  
  1762.  
  1763. txt_multibuf
  1764.  
  1765. What is MultiBuf ?
  1766. =================================
  1767.  
  1768. MultiBuf is an support program written especially for use from
  1769. within KBackup. It is covered by the same copyright and conditions of
  1770. use that apply to KBackup.
  1771.  
  1772. It is intended to be a reliable and transparent handler for
  1773. multivolume  archives, superior to both
  1774. afio(1) and tar(1). multivolume archives
  1775.  
  1776. One of its most most advanced features is, that it automatically determines the
  1777. length of your tapes. You can write multiple volume archives to a series of
  1778. tapes having different lengths. You can also use MultiBuf to automatically
  1779. change tapes if you have an automated tape changer.
  1780. This simply involves redefining the commands used to interact
  1781. with the user. Instead of prompting for the next tape, they can autoload
  1782. it. If you are interested in this feature, please contact the author, so we
  1783. can fit this feature into the official release. I'd be glad to help you
  1784. with this in any way.
  1785.  
  1786.  
  1787. The information in this section is only of interest, if you want to
  1788. understand how it works or use it as a standalone program for some
  1789. other purpose. You do not need to understand this to use KBackup, as
  1790. the use of MultiBuf is fully automated. However, if you are concerned
  1791. about compatibility, the data format used or restoring files without
  1792. KBackup, continue to read this section.
  1793.  
  1794.  
  1795. How does it work?
  1796. =================================
  1797.  
  1798. MultiBuf can be run in two modes,  ``write--mode'' (default) and
  1799. ``read--mode''. In ``write--mode'', it reads data in small blocks from
  1800. stdin and writes it in bigger chunks (``superblocks'') of
  1801. several blocks to the
  1802. output device specified. In ``read--mode'', it does the contrary,
  1803. reading big chunks of data from the device and outputs the data to
  1804. stdout. 
  1805.  
  1806. Whenever writing a big data chunk fails, MultiBuf assumes that it
  1807. has reached the end of the backup medium (e.g. end of tape) and
  1808. executes one of two user-definable commands. On successful execution
  1809. of this command, it optionally executes a second command and then
  1810. continues writing to the device with the last block that did not fit
  1811. onto the medium before. During restoration of the data, it does more
  1812. or less the same, prompting the user when it cannot read a complete
  1813. chunk of data. It is important to mention, that for writing and
  1814. reading data, you need to use the same block sizes and number of
  1815. blocks per superblock!
  1816.  
  1817. To improve reliability and error checking, MultiBuf can write
  1818. so-called ``sequence information headers'' to the tape.
  1819.  
  1820. These headers tell MultiBuf about the right order of backup media and
  1821. thus prevents you from using the tapes in the wrong order.
  1822. Further on, this enables MultiBuf to distinguish between an ``end of
  1823. medium'' and an ``end of file'', sparing you some unnecessary and
  1824. possibly confusing dialogs. Also, this increases the number of files
  1825. per backup  on a tape from currently three to five, because two
  1826. additional short end--markers get written.
  1827. On mountable block devicesmountable block
  1828. devices MultiBuf will write the end markers
  1829. as separate small files.
  1830.  
  1831.  
  1832. The Multivolume Archive
  1833. =================================
  1834. --Menu
  1835. This section describes the Multivolume Archive--menu of
  1836. KBackup, from which you can change the MultiBuf related options.
  1837.  
  1838.  
  1839. Set MultiBuf block size
  1840. =================
  1841.  
  1842. This determines the smallest block of data, MultiBuf will deal
  1843. with. It should be an integral multiple of the block size of
  1844. your tape. Usually a value of 1024 should be used.
  1845.  
  1846.  
  1847. Set number of MultiBuf blocks per call
  1848. =================
  1849.  
  1850. To avoid unnecessary overhead, MultiBuf always writes (or reads) a
  1851. couple of data blocks at once to (from) tape. Making this value large
  1852. slightly reduces CPU usage, but makes it waste a bit of space at the
  1853. end of every tape. I suggest using a value that is both significantly
  1854. lower (when multiplied with the block size) than your tape's capacity
  1855. as well as much bigger than the relatively small block size. 
  1856. The standard value is 100, giving you (with a block size of 1024) a
  1857. total buffer size of 100~Kbytes. So you can be sure to waste no more
  1858. than 100~K per tape and still reduce CPU overhead by two orders of
  1859. magnitude. 
  1860.  
  1861.  
  1862. Use sequence information in MultiBuf
  1863. =================
  1864.  
  1865. This has two effects:
  1866.  
  1867.  
  1868.  * 
  1869. It enables MultiBuf to distinguish between the end of a file on the
  1870. tape, like e.g. the end of the archive or contents directory, from the
  1871. physical end of the tape. If you disable this switch, MultiBuf will
  1872. ask you whether to continue with the next medium whenever it detects
  1873. an end of file. So you have to explicitly tell it ``NO'' after it has
  1874. read the contents directory or after having read all the archive!
  1875.  * 
  1876. It writes some sequence information to the tape and thus prevents you
  1877. from using your tapes in the wrong order.
  1878.  
  1879.  
  1880. txt_seqinfo
  1881.  
  1882.  
  1883. MultiBuf Command Line Options
  1884. =================================
  1885.  
  1886. When used with the option --help, MultiBuf will show you a
  1887. screen like this:
  1888.  
  1889.  
  1890. verbatim
  1891. MultiBuf Revision: 1.1        (C) 1995 by Karsten Ballⁿder
  1892.                            Karsten.Ballueder@stud.uni-karlsruhe.de
  1893. USAGE: /home/karsten/KBackup/multibuf/multibuf options filename
  1894. valid options:
  1895.    -r, --read        : set read mode
  1896.    -w, --write        : set write mode (default)
  1897.    -v, --verbose    : verbose progress reporting
  1898.    -b, --blocksize    : set size of each data block in bytes
  1899.    -n, --nblocks    : set number of blocks in each superblock
  1900.    -c, --command "shell-command"  : set command to execute at end of medium
  1901.    -C, --command2 "shell-command" : set command to execute at begin of medium
  1902.    -R, --retry-command "shell-command" : set command to execute when finding
  1903.                           wrong sequence number
  1904.    -1, --end-only    : only execute command at end of media
  1905.    -2, --begin-and-end    : exeute commands at end and begin of media
  1906.    -s, --settings    : display settings
  1907.    -x, --exit        : exit after processing options (for testing)
  1908.    -h, --header        : add header/sequence information to data
  1909.    -E, --no-endmarker   : do not use an endmarker
  1910.    -F, --file-endmarker : write endmarker as a file on a mounted medium
  1911.    -D, --disable-filemark-fix : for debugging purpose only
  1912.    -V, --version    : print version information
  1913.    return codes: 0=success, 1=read error, 2=write error, 3=wrong sequence
  1914. verbatim
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921. Appendix:            The FAQ
  1922. =========================================================================
  1923.  
  1924. txt_faq
  1925.  
  1926. Introducing the FAQ
  1927. =================================
  1928.  
  1929. This FAQ is not very long at the moment, because most of the questions
  1930. about KBackup versions 1.0 and 1.1 do not apply any longer. They
  1931. concerned bugs removed in this version. 
  1932.  
  1933. However, I am confident that I will receive lots and lots of
  1934. questions about this version as well, so I have decided to start a FAQ
  1935. on it. This will be constantly being updated, the latest version of it
  1936. will always be available via the KBackup
  1937. homepagehttp://www.uni-karlsruhe.de/~ Karsten.Ballueder. If you have
  1938. any questions, mail them to me at:
  1939. .ballueder@stud.uni-karlsruhe.de
  1940. or use your web--browser:
  1941. send mailmailto:karsten.ballueder@stud.uni-karlsruhe.de.
  1942.  
  1943.  
  1944. How can I ?
  1945. =================================
  1946.  
  1947.  
  1948.  
  1949. Exclude a directory tree from backup?
  1950. =================
  1951.  
  1952. To exclude a directory and all its sub-directories from the backup,
  1953. you can list it in the exclude list (Configuration/File
  1954. selection--menu). This was broken in versions before 1.2 but is fixed
  1955. now. Just specify the name of the directory relative to your parent
  1956. directory. E.g. if your parent directory is ``/'' and you
  1957. want to exclude ``/proc'', just specify ``proc''
  1958. only. This would exclude the whole process--filesystem.
  1959.  
  1960.  
  1961. Restore my files manually?
  1962. =================
  1963.  
  1964. Well, that is fairly simple. To restore from a tape, you can do this
  1965. (assuming that ``/dev/tape'' is a link to your tape device):
  1966.  
  1967. First you have to ``cd'' to the directoy to where you want to
  1968. restore the files. Then:
  1969. verbatim
  1970. mt rewind            # to rewind your tape
  1971. cat /dev/tape            # this will show you the archive header
  1972. cat /dev/tape >/dev/null    # this will skips the contents directory
  1973. verbatim
  1974.  
  1975. Depending on whether you used AFIO or TAR format, do one
  1976. of the following (using double buffering and decompression):
  1977. verbatim
  1978. multibuf -r -h /dev/tape | dd obs=4096k | afio -i -vzZk - # for AFIO
  1979. multibuf -r -h /dev/tape | dd obs=4096k | tar -xzvf -      # for TAR
  1980. verbatim
  1981. The options for afio(1) and tar(1) depend on whether you
  1982. used compression or not. See their manpages for details.
  1983.  
  1984. For floppy disks, using afio(1) is rather simple, just type:
  1985. verbatim
  1986. afio -i -vF -s 1440 -G /dev/fd0H1440
  1987. verbatim
  1988. For higher capacity floppy formats, you need to adjust the numbers;
  1989. without compression, drop the ``-G'' option.
  1990.  
  1991. For mountable block devices, this is tricky. You can restore
  1992. them manually. It goes like this:
  1993. verbatim
  1994. multibuf -r -h -F -c ``...'' -C ``...'' /mnt/Archive | afio -i -vzZ -
  1995. verbatim
  1996. The arguments to the ``-c'' and ``-C'' must be set
  1997. to mount and unmount the volume at ``/mnt'', for example like this:
  1998.  -c ``umount /mnt ; echo Next Volume...; read ''
  1999.  -C ``mount /dev/fd0 /mnt -t minix''
  2000.  
  2001.  
  2002. Restore a system no longer booting?
  2003. =================
  2004.  
  2005. If you cannot boot your system any longer, the first thing you need to
  2006. get is a Bootdisk--set. This is something you should have prepared
  2007. just after installing your system. In case that your main 
  2008.  partitions are no longer accessible, not even from a boot disk, you
  2009. need to recreate them and then you can use KBackup to restore your
  2010. data onto them. As soon as the KBackup--Rescue--Disk is available,
  2011. you can use this one to boot and do all this. Until then it is
  2012. probably easiest to reinstall a minimal  system, install
  2013. KBackup on this new system and then use it to restore your
  2014. files. Fitting KBackup on a root--disk proves to be tricky, but I
  2015. expect to release the Rescue--Disk soon. 
  2016.  
  2017.  
  2018.  
  2019. How can I use my removable hard disk?
  2020. =================
  2021.  
  2022. Use the BLOCKDEV archive type and configure the appropiate
  2023. commands for making a filesystem. This should work with any removable
  2024. hard disk.
  2025.  
  2026.  
  2027. Can I ?
  2028. =================================
  2029.  
  2030.  
  2031. Can I make backups of my DOS partitions?
  2032. =================
  2033.  
  2034. YES. KBackup can make backups of any filesystems mounted. To make a backup
  2035. of your DOS (or whatsoever) partitions, simply mount them to an appropiate
  2036. place and go ahead. 
  2037.  
  2038. Can I make backups over the network?
  2039. =================
  2040.  
  2041. YES. Well, probably. On the 
  2042. KBackup Homepagehttp://www.uni-karlsruhe.de/~Karsten.Ballueder/ 
  2043. you can find a version of KBackup supporting remote devices. Get it and
  2044. read its README file for details.
  2045.  
  2046.  
  2047. Common problems
  2048. =================================
  2049.  
  2050.  
  2051. I cannot read or verify any tape archive.
  2052. =================
  2053.  
  2054. Well, maybe you are using the rewind-on-close device. You must
  2055. use the non-rewind-on-close device (e.g. ``/dev/nrm*''). See
  2056. also the ``No valid KBackup header'' question in this section.
  2057.  
  2058.  
  2059.  
  2060. I cannot restore my old archives.
  2061. =================
  2062.  
  2063. If you have trouble restoring your old KBackup archives, generated with
  2064. earlier version of the software, contact the author.
  2065.  
  2066. If you are using KBackup version $1.2.x$ with $x < 3$, upgrade to a more 
  2067. recent version. KBackup should detect the old archive format and restore
  2068. it properly.
  2069.  
  2070.  
  2071. I get ``No valid KBackup header''
  2072. =================
  2073.  
  2074. If KBackup cannot find a valid header on your backup medium, although
  2075. you have written an archive to it using KBackup, than there is
  2076. (hopefully) only one possible reason for this: you are using a tape
  2077. device that rewinds after closing a file. KBackup requires you to
  2078. specify a device that does not rewind on close. These devices
  2079. often  carry an ``n'' in their name. If you try using a device with
  2080. rewind-on-close feature, KBackup will overwrite its header with the
  2081.  
  2082. directory and afterwards overwrite the directory with the actual
  2083. archive, instead of writing the files one after another.
  2084.  
  2085. In version $1.2.3$, I have introduced an option to check a tape device for
  2086. compatibility with KBackup and also autodetect the proper device file.
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092. My floppy streamer doesn't work (ftape)
  2093. =================
  2094.  
  2095.  
  2096. To use tape drives accessed through the floppy controller, you need to install 
  2097. the proper kernel driver. Of course, this is generally true for all drives.
  2098. First of all, you need to recompile your kernel and enable support for QIC-117
  2099. (FTAPE) (and, of course, install your new kernel). 
  2100. Before using the new driver you not only have to reboot but also
  2101. load the module into the kernel. A simple recompilation won't do.
  2102. Then, KBackup should work with your device.
  2103.  
  2104. KBackup does not work with zftape.
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110. Appendix:            The Conditions of Use
  2111. =========================================================================
  2112.  
  2113. txt_copying
  2114.  
  2115.  Copyright (C) 1995, 1996 Karsten Ballⁿder
  2116.  
  2117.  
  2118. Karsten.Ballueder@stud.uni-karlsruhe.de)
  2119.  
  2120. http://www.uni-karlsruhe.de/~ Karsten.Ballueder/
  2121.  
  2122. Karsten Ballⁿder, Lessingstrasse 2, 32756 Detmold, Germany
  2123.  
  2124.  
  2125.  
  2126. 2
  2127.    
  2128.    Redistribution and use for non-commercial purposes in source and 
  2129.    binary forms are permitted provided that the above copyright 
  2130.    notice and this document are duplicated in all such forms and that 
  2131.    any documentation, advertising materials, and other materials 
  2132.    related to such distribution and use acknowledge that the software 
  2133.    was developed by Karsten Ballueder. 
  2134.  
  2135.    This is SHAREWARE. As you will see from the following paragraphs,
  2136.    I am trying to keep this as simple as possible while still
  2137.    trying to get some benefit for myself from this software. 
  2138.    It is an awful lot of work writing and maintainig such a package,
  2139.    so please take the time to read this and comply to it.
  2140.  
  2141.    
  2142. Using KBackup at home:
  2143.    You are granted the right to use KBackup for private purpose 
  2144.    free of charge, under the one simple condition of sending me a picture
  2145.    postcard. This will also register you for further information on
  2146.    KBackup development (and keep me motivated to continue this work). 
  2147.    You do not need to send me any money, however,
  2148.    if you feel like, I wouldn't mind. :-)
  2149.  
  2150. Using KBackup in a commercial environment:
  2151.    A license for using KBackup in a commercial or educational environment 
  2152.    can be obtained from the author for a small fee. To register your copy 
  2153.    of KBackup, contact the author at the address above
  2154.    or just send an email. Registration fees for a ``small'' environment
  2155.    start from US $30 and are negotiable. This will enable you to receive
  2156.    full support and information on KBackup development from the author.
  2157.    
  2158. NO WARRANTY:
  2159.    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 
  2160.    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  2161.    OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  2162. NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY  
  2163.    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF 
  2164.    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  2165. WITH THE  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  2166.  
  2167.  
  2168.  
  2169. Distributions:
  2170.    I would like to make KBackup accessible to as many people as possible.
  2171.    Therefor I grant the permission to include KBackup in any Linux
  2172.    distributions, as long as it is only a minor part of the distribution.
  2173.    You are not allowed to sell or distribute any software package which
  2174.    based mainly or derived from KBackup withour prior written permission
  2175.    from the author.
  2176.    
  2177.    If you are in doubt whether you can distribute KBackup or not, just
  2178.    contact the author. Including it in a distribution which is also
  2179.    available free of charge (e.g. by FTP), is fine.
  2180.  
  2181. If you include KBackup in a software distribution, I would like you
  2182. to send me a copy of that distribution, however, this is not
  2183. compulsory.
  2184.  
  2185. If you have any questions about distributing KBackup, contact the author.
  2186.  
  2187.  
  2188.